Fritz: All Fritz/All Fritz.zip/All Fritz/FILES/DESKHING/RUBICON1.LZH/RUP22C.EXE/MANUAL.1

Text File | 1991-06-08 | 27KB | 692 lines

                     ******************************
                     *                            *
                     *   THE RUBICON PUBLISHER    *
                     *        Version 2.2C        *
                     *                            *
                     ******************************

                       _________________________
                      |                         |
                      |    TABLE OF CONTENTS    |
                      |_________________________|


Section 1: PRELIMINARIES

1.1 Using this manual
1.2 Installation Requirements
1.3 Installing the Software
1.4 Licensing and Registration
1.5 Terms and Conditions of Licence

Section 2: OPERATION AND STRUCTURE

2.1 General Description
2.2 Operating Environment
2.3 Outline of Operating Procedure
2.4 Run-Time Options
2.5 Tag Command Syntax
2.6 Units of Measurement
2.7 "Include" Files
2.8 Default Style Sheet: SETUP.TAG
2.9 Order of Processing Text and Instructions
2.10 "Push" and "Pop"

Section 3: FONTS AND SYMBOLS

3.1 Font Enhancements
3.2 Soft Fonts
3.3 Font Changes
3.4 Space Commands
3.5 Enabling and Disabling the Printhead
3.6 Extra Symbols

Section 4: ALIGNMENT AND JUSTIFICATION

4.1 Line Breaks
4.2 Justification
4.3 Justifying Fill

Section 5: PRINTHEAD CONTROL

5.1 Baseline Motion
5.2 Kerning, Tracking and Expansion
5.3 Diphthongs
5.4 Ligatures

Section 6: PARAGRAPHS

6.1 Indentation and Paragraphs
6.2 Horizontal Tab Mode
6.3 Vertical Tab Mode

Section 7: PAGE LAYOUT

7.1 Page Styles
7.2 Multiple Columns
7.3 Leading (Line Spacing)
7.4 Headers and Footers
7.5 Layout Printing Sequence
7.6 The Folio (Page Number)
7.7 Vertical Justification
7.8 Widows and Orphans
7.9 Page Layout Over-Rides

Section 8: THE STYLE SHEET

8.1 Obtaining a Style Sheet
8.2 Elements of a Style Sheet
8.3 Using a Style Sheet

APPENDIX

A.1 Installation
A.2 Access From Any Directory
A.3 Increasing Open Files Limit


                      ___________________________
                     |                           |
                     |  Section 1: PRELIMINARIES |
                     |___________________________|


CONTENTS

1.1 Using this manual
1.2 Installation Requirements
     1.2.1 Environment
     1.2.2 Distribution Set
     1.2.3 Pre-Installation Procedures
1.3 Installing the Software
1.4 Licensing and Registration
1.5 Terms and Conditions of Licence

1.1 USING THIS MANUAL

This Concise Manual is designed to function as a basic instruction
manual, to enable you to install the Publisher and make sufficient use
of it to make a proper assessment of its capabilities.  The complete
instruction and reference manual including a Quick Reference Guide, a
set of standard style sheets, a Problem Solving Guide, appendices,
examples, a glossary of technical terms and an alphabetical index, is
too lengthy for inclusion on a distribution diskette.  A copy of it in
printed form is shipped to all users who register and pay the prescribed
licence fee, as described in Section 1.4.


1.2 INSTALLATION REQUIREMENTS

     1.2.1 ENVIRONMENT

Rubicon Publisher 2.2C may be installed on any IBM personal computer
(PC/XT, PC/AT or PS/2) or other compatible microcomputer which uses the
MS-DOS operating system, version 2.1 or newer. The Publisher can be
operated without a graphics card, but the optional Screen Preview
feature cannot be used unless the computer and monitor support VGA
graphics (monochrome or color).

The Publisher supports PostScript printers, most laser printers, and a
wide selection of other printers, including most popular 9-pin and
24-pin dot-matrix printers: a detailed list is given in Item 4 in
Section 1.2.3, below.

IMPORTANT NOTE ABOUT DOT-MATRIX PRINTERS: The Publisher drives
dot-matrix (and similar) printers in GRAPHICS MODE, which requires
RELIABLE AND PRECISE PAPER FEED, and ACCURATE CONTROL OF PRINTHEAD
MOVEMENT. Some printers (not necessarily the oldest or least expensive
models) are poorly designed in these respects; and printers which are
worn out by long use, or are in need of servicing or lubrication, may
also exhibit "sloppy" paper feed or printhead movement. Such printers
may work well enough in "text" mode, but may fail to operate
satisfactorily in graphics mode. If used with the Publisher, they
typically produce lines of print which are distorted horizontally or
vertically and/or disfigured by horizontal white lines. These conditions
indicate a HARDWARE PROBLEM, not a defect or "bug" in the software.

"Sloppy" paper feed is sometimes caused by
   * incorrect paper path through the printer;
   * obstruction or misalignment of the path followed by the paper
          before it enters or after it leaves the printer;
   * use of poor-quality computer paper;
   * use of a type of paper not suited to your printer's feed mechanism
          (for example, some printers cannot handle extra-heavy paper
          stock or 3-part forms accurately enough for graphics mode).

If you encounter the problems described above, you should check these
possibilities before concluding that your printer will not work with the
Publisher. Also, some printers support alternative paper paths or feed
modes. In this case, the path and mode which provide the smoothest and
most accurate paper feed should be used when the printer is being driven
by the Publisher. In particular, if your tractor feed supports both a
"push" and a "pull" mode, the "pull" mode should be used with the
Publisher.

     1.2.2 DISTRIBUTION SET

Rubicon Publisher Version 2.2C is distributed on magnetic media and
bulletin boards in compressed (or "archive") form, with an interactive
installation program. The set of distribution files consists of two
plain ASCII text files, README and MANUAL.1, and five (5)
self-extracting compressed files: RUP22C.EXE, 120X72.EXE, INSTALL.EXE,
300X300.EXE, and 180X180.EXE. A 360KB format distribution set consists
of two disks:

             Disk 1                         Disk 2
         ---------------                   ---------
    README         120X72.EXE              300X300.EXE
    MANUAL.1      INSTALL.EXE              180X180.EXE
    RUP22C.EXE

You are now reading file MANUAL.1.


     1.2.3 PRE-INSTALLATION PROCEDURES

BEFORE ATTEMPTING TO INSTALL THE PUBLISHER:

1. Make sure that you have the 7 files listed above, and that these are
the ONLY Rubicon Publisher files you have. DO NOT expand any of the
compressed files before installing the Publisher: the Installation
program will expand them automatically, as and when required. (If you
have already expanded some of these files, please delete the files
created by the expansion, before proceeding further.) If you have
downloaded from a bulletin board, you should also ensure that the 7
distribution files are ALL on the SAME DIRECTORY. To avoid conflict with
the installation procedure, this directory should NOT be named
"RUBICON".

2. Determine which drive the Publisher is to be installed on. We
recommend that you install the Publisher on a hard disk drive, if
possible. If the Publisher is being installed for a 120x72 dpi printer
(most 9-pin dot-matrix printers), or for a PostScript or LaserJet III
printer, at least 720 KB of space should be available for the
installation. If it is being installed for a 180x180 dpi printer (most
24-pin dot-matrix) or a 300x300 dpi printer (other than PostScript or
LaserJet III), an additional space of at least 500 KB should be available
for storing the necessary soft fonts.

3. Determine whether your computer supports VGA graphics: that is,
whether it has a VGA graphics card and a compatible monitor. (Refer to
your computer's instruction manual if necessary.) If you have VGA, you
can install the Publisher's optional Screen Preview feature, which will
enable you to display published documents on your video screen for
inspection, before printing them. (If your computer does not support
VGA, you can still install and use the Publisher, but the Screen Preview
will not be available.)

Note: The Preview can be INSTALLED on any system which supports VGA
     graphics, but cannot be USED to preview documents being published
     with PostScript or LaserJet-3 devices, or LaserJet-2 documents
     using Landscape printing.

4. Identify the make and model of printer for which the Publisher is to
be installed, with reference to the list of supported printers given
below.

Note (a): If your printer is not on the list, it may be possible to set
     it up to emulate one of the listed printers. For example, numerous
     models of 9-pin dot-matrix printers can be set up to emulate an
     Epson FX-80. If you have one of these, you can install the
     Publisher for an Epson FX-80, and use it to drive your printer in
     FX-80 mode.

Note (b): If you install the Publisher for an emulation that does not
     work satisfactorily, you can re-install for a different printer
     model (provided that it uses the same resolution as the first one)
     without repeating the entire installation procedure. To perform
     such a printer re-installation, log on to the directory where the
     Publisher has been installed (usually C:\RUBICON), and enter the
     command "SELECTP". The printer selection menu will appear. Proceed
     as in Step G in Section 1.3, below.

Note (c): It is technically possible to install the Publisher for
     multiple printers. However, your first installation should be made
     for a single printer. Multiple printer installations require the
     creation of customized configuration files and should be attempted
     only by persons who are completely familiar with the Publisher's
     operating principles and command language.

Note (d): If your printer is not listed below and will not emulate a
     listed printer, a version of the Publisher which supports your
     printer may be available on special order. Enquiries should be
     directed to Rubicon Computer Labs Inc., at the address given in
     Section 1.4.

                    DOT MATRIX and INK-JET PRINTERS
                    -------------------------------

72x120 DPI PRINTERS (Includes Most 9-Pin Printers)
--------------------------------------------------

AEG Olympia NP 80SE
Alps ASP160
Alps P2000
Alps P2100
Brother M-1009
Brother M-1109
Brother M-1509
Brother M-1909 B&W
Brother M-1909 Color
Bull Compuprint 4/22
Bull Compuprint 4/23
Bull Compuprint 4/40
Bull Compuprint 4/43
C-Tech C-515
C-Tech ProWriter C-240
C-Tech ProWriter C-245
C. Itoh CI-3500
CIE CI-5000
Canon BJ-10e
Canon PW-1040A
Canon PW-1156A
Centronix GLP II
Citizen 120D
Citizen 180D
Citizen 200GX
Citizen MSP-10/15
Citizen MSP-20/25
Citizen MSP-45
Citizen MSP-50/55
DEC LA 324
DEC LA 75
Dataproducts 9030
Epson DFX-8000
Epson EX-800
Epson FX-100
Epson FX-1050
Epson FX-286e
Epson FX-80
Epson FX-80e
Epson FX-85
Epson FX-850
Epson JX-80 (B/W)
Epson JX-80 (Color)
Epson LQ-1500
Epson LX-80
Epson LX-800
Epson MX-100
Epson MX-80
Epson RX-80
Facit 4512
Facit B1200
Fortis DM3215
Fortis/Dynax DM1310
Fortis/Dynax DM2015
Fujitsu DX-2200-F
Fujitsu DX-2200-I
Fujitsu DX-2400 (B/W)
Fujitsu DX-2400 Color
Genicom 3840
IBM 3852-2 Jet 8 Color
IBM PC Graphics Printer
IBM Proprinter
IBM Proprinter II/XL
IBM Proprinter X24/XL24
Juki 5510
MT Spirit-80
Mannesmann Tally 130/24
Mannesmann Tally 130/9
Mannesmann Tally 131/24
Mannesmann Tally 131/9
Mannesmann Tally MT-290
NCR 6417-0101
NCR 6417-0201
NEC Pinwriter P2/P3
NLQ SC-1200
NLQ SC-1500
Nissho NP-910
Okidata ML192/193 (IBM)
Okidata ML92/93 (IBM)
Olivetti DM105S
Olivetti DM309E
Panasonic KX-P1080
Panasonic KX-P1090
Panasonic KX-P1091
Panasonic KX-P1092
Panasonic KX-P1124
Panasonic KX-P1180
Panasonic KX-P1592
Panasonic KX-P1595
Panasonic KX-P3131
Printronix S7024
QMS Smart Writer
Seikosha SP-2000
Seikosha Sk-3000AI (B/W)
Star Micronix Delta 10
Star Micronix Gemini 10x
Star Micronix Gemini 15x
Star Micronix NX-10
Star Micronix NX-1000
Star Micronix Radix 10
Star Micronix XR-1000
TI 850
TI 8930
Tandy DMP 2130
Tandy DMP-2100 (IBM)
Tandy DMP-430 (IBM)


180x180 DPI PRINTERS (Includes Most 24-Pin Printers)
----------------------------------------------------

AEG Olympia NP 80-24
Alps Allegro 500 24-pin
Alps Allegro 500XT
Brother M-1924L
Bull Compuprint 4/54
C-Tech C-610 Plus
C-Tech C-610C Plus
C-Tech C-645
C. Itoh C-815
Citizen GSX-140
Citizen Tribute 224
Copal Writehand 6800
DataProducts 9044
Epson LQ-2500 24-pin
Facit B3450 24-pin
Fujitsu DL4600
NEC Pinwriter P2200 180
NEC Pinwriter P5/6/7 180
NEC Pinwriter P6200
NEC Pinwriter P6300
Nissho NP-2410
Okidata Microline 380
Okidata Microline 390
Okidata Microline 391
Okidata Microline 393
Olivetti DM600S
Panasonic KX-P1624
Panasonic KX-P1654
Seikosha SL-90
Star Micronix NX-2400
Star Micronix NX-2410
Star Micronix NX-2415
Tandy DMP 240
Tandy DMP-2110
Toshiba 1350
Toshiba 1351 (24p)
Toshiba 1351 (8p)
Toshiba P321, P321SL/SX
Toshiba P351, P351C


                          POSTSCRIPT DEVICES
                          ------------------
The Publisher supports ALL PostScript devices, using the `PostScript'
installation option. The installation procedure for such printers does
not require designation of the specific make or model of printer.


                            LASER PRINTERS
                          ------------------

The Publisher has two printer driver options for laser printers other
than PostScript devices, as follows.

LaserJet-2
----------
This option supports all laser printers which use Hewlett-Packard PCL4
printer commands, including

LaserJet+ and 500+
LaserJet 2000
LaserJet II series (IIP, IID, etc.)
LaserJet III operating in LaserJet II mode.

MOST LASER PRINTERS (other than PostScript printers) use Hewlett-Packard
PCL4 printer commands in their normal operating mode, or in an optional
`LaserJet emulation' mode. The Publisher is installed for all such
printers by using the LaserJet-2 installation option. The installation
procedure for such printers does not require designation of the specific
make or model of printer.

LaserJet-3
----------
This option supports the LaserJet III operating in LaserJet III mode,
that is, using the Hewlett-Packard PCL5 printer command language and the
scalable fonts built into the LaserJet III.


1.3 INSTALLING THE SOFTWARE

The installation program will install the Publisher on any drive
specified by the user, provided that the designated drive has sufficient
space available. (See item 2 in Section 1.2.3, above.) NOTE: There must
be no existing directories named "RUBICON" or "RUFONT" on the drive
where the Publisher will be installed.

If you are installing the Publisher from distribution diskette(s), the
first step is to load the distribution diskette (or distribution diskette
No. 1, if there are more than one) into diskette drive `A' or `B', and log
on to the selected drive.

If you have downloaded from a bulletin board, the first installation
step is to log on to the directory where the downloaded files are
located.

Then proceed as follows:

A. Start the installation program by entering the command
                       INSTALL [drive_letter]
where "drive_letter" identifies the drive on which you wish to install
the Publisher. (If no drive letter is specified, it will be assumed that
Drive C is intended.) By means of a screen message, the program will
confirm the drive on which the publisher is to be installed. If it is
correct, enter "c" to continue: otherwise, enter "q" to abort, and begin
again.

B. The installation program will next display the following menu:

                    Install a Printer?
                         1. LaserJet-2
                         2. Postscript
                         3. LaserJet-3
                         4. 9-Pin Dot Matrix; 120x72 dpi
                         5. 24-Pin Dot-Matrix; 180x180 dpi
                         6. No Printer

Indicate your printer selection by entering the appropriate number, for
example, "4" for a 9-pin dot matrix printer.

C. The program will confirm the printer option selected, and then
display the prompt:
                    Specify Printer Port? [No]

Normally, the printer you will be using with the Publisher will already
be installed on your computer as the DOS PRN standard printer device. In
this case, you should enter "n" for No, and proceed directly to Step D.
(If you have only one printer, this will almost certainly be true,
unless your printer is a SERIAL LaserJet, SERIAL LaserJet emulator, or
SERIAL PostScript device.)

          [A Yes answer to this prompt is required only if you are
          installing the Publisher for a printer which will NOT be
          driven as the DOS PRN device. This seldom arises, unless:

          (a) you have more than one printer connected to your computer.
          In this case, it MAY be necessary to specify a particular
          printer port for the Publisher installation. If so, enter "y"
          for Yes. The program will then display a menu of 6 printer
          port options. Select the desired option by entering the
          corresponding number, for example "2" for Parallel Port LPT1,
          or "5" for Serial Port COM1. The program will confirm the
          option selected.

          (b) your printer is a SERIAL LaserJet, SERIAL LaserJet
          emulator, or SERIAL PostScript device.) The MS-DOS printer
          driver is NOT SUITABLE for a LaserJet or LaserJet emulator
          driven through a SERIAL (RS232C) interface, nor is it suitable
          for some popular SERIAL PostScript devices, such as the Apple
          LaserWriter. These serial devices all require the Xon/Xoff
          handshaking protocol, which is not supported by the MS-DOS
          serial driver. To provide full and proper support for
          LaserJet-2, LaserJet-3 and PostScript type serial devices
          requiring the Xon/Xoff protocol, the Publisher includes the
          "Greenleaf" serial driver, as an option. If you are installing
          the Publisher for use with one of these serial devices, you
          should enter "y" for Yes. The program will then display a menu
          of 6 printer port options. Select the serial port your printer
          is connected to, by entering the corresponding number, "5" for
          Serial Port COM1, or "6" for Serial Port Com2. The program
          will confirm the serial port selected, and will AUTOMATICALLY
          select the Greenleaf printer driver option.]

D. The program will display the prompt:
                    Install another printer? [No]
Enter "n" for No, and proceed directly to Step E.

          ["y" is entered only if you are attempting a multiple-printer
          installation. The Publisher supports such installations, but
          they require user-created configuration files, etc., and
          should be attempted only by users who are thoroughly familiar
          with the Publisher.]

E. The program will display the prompt:

          The Preview requires a VGA card. Install VGA Preview? [No]

If your computer has a VGA card, enter "y" for Yes. If not, enter "n".

The program will display a summary of the installation instructions you
have given it. If they are correct, enter "c" to continue: otherwise,
enter "q" to abort, and begin again.

F. The program will proceed to create the necessary directories on the
designated drive, copy Publisher files to them, and expand the files,
which typically takes several minutes. Screen messages will indicate the
progress being made. NOTE: If you are using a 360 kb format 2-disk
installation set, Disk 2 will be needed only if you have selected the
LaserJet-2 or 24-pin dot-matrix printer option (selection 1 or 5 at Step
B). In this case, the program will prompt you to insert Disk 2 at the
proper time.

G. If you have selected a 9-pin or 24-pin dot-matrix printer (option 4
or 5 at Step B) the program will display a menu of printer models,
arranged alphabetically. Otherwise, the program will go directly to
Step H.

If the printer menu appears, use the [cursor down] and [cursor up] arrow
keys to move through the menu until you reach the listing for your
printer. (The menu is several screens long, and scrolls automatically.)
Press the [Enter] key to select the desired printer when you reach it.

The program will then perform the remaining installation steps.

H. The program will display a screen message indicating that the
installation is complete, and will return you to the DOS prompt. The
Publisher has now been installed.

If questions or problems arise during installation, or if you wish to
employ a more complicated installation procedure for sophisticated
users, which is required for certain hardware setups, and enables the
Publisher to be accessed from any directory, please refer to the
Appendix to this Manual, in file MANUAL.APP.

BEFORE USING THE PUBLISHER:

1. Refer to the file README on the Rubicon directory. If you have not
already read it, please read it carefully now.

2. Use the Publisher to publish the Samples and Tutorial, by following
the detailed instructions in README.

3. Use the Tutorial to teach yourself how to use the Publisher.


NOTE: 1. When publishing certain documents, the Publisher may need to
have as many as 10 files open simultaneously.  Unless it has been
configured to permit a greater number, the MS-DOS operating system will
only permit 8 files to be open at once.  If your operating system has
not been so configured, attempting to publish certain documents may
result in an error message to the effect that too many files are open.
If this problem arises, please refer to the Appendix, section A.2.3.

      2. If you will be using a SERIAL PRINTER or other serial output
device, or will be using HEWLETT-PACKARD SOFT FONTS, or will be using
MORE THAN ONE PRINTER, after running the INSTALL program, you should
refer to the appropriate sections of the Appendix to this Manual, in
file MANUAL.APP.

1.4  LICENSING AND REGISTRATION

If you have purchased the COMMERCIAL VERSION of the Publisher from
Rubicon Software or an authorized dealer, you have been automatically
registered as a licensee, and granted a User's Licence on the terms
specified in Section 1.5. [IF YOU DON'T HAVE A PRINTED COPY OF THE
COMPLETE REFERENCE MANUAL, YOU DON'T HAVE THE COMMERCIAL EDITION OF THE
PUBLISHER: YOU HAVE THE SHAREWARE EDITION.]

If you have purchased a copy of the Publisher as SHAREWARE, or have
obtained a usable copy of the Publisher by any other means, such as
copying from another computer, or making an additional installation from
a distribution diskette, you may use it only for purposes of EVALUATION,
DEMONSTRATION OR REVIEW, and you may make and distribute further copies
only for those purposes. USE FOR ANY OTHER PURPOSE IS CONTRARY TO LAW,
UNTIL YOU HAVE REMITTED THE PRESCRIBED USER'S LICENCE FEE TO OUR MAILING
ADDRESS FOR REGISTRATIONS:

                    RUBICON COMPUTER LABS INC.
                    P.O. Box 336
                    Chelsea, Quebec, Canada
                    J0X 1N0

License fees and other particulars are given in the files REGFORM.CAN
(for Canadian purchasers), REGFORM.US (for the United States),
REGFORM.UK (for the U.K and Europe), REGFORM.ANZ (for Australia and New
Zealand) and REGFORM.FOR (for all other locations), which can be
PUBLished to produce registration and order forms.

1.5 TERMS AND CONDITIONS OF LICENCE

On payment of the prescribed licence fee for the designated version of
the Rubicon Publisher, you will receive a copy of the current Commercial
Edition of the selected version of the Publisher (including printed
documentation), and will be granted a licence to use it on the following
terms and conditions:

1.  The Purchaser may install the Rubicon Publisher and soft fonts
[hereinafter referred to as ``the Software''] on a single computer and
use it for all normal purposes, both private and commercial.

2.  The Purchaser may re-install the Software if the originally-
installed copy is lost or impaired by human error, equipment failure, or
like cause.

3.  The Purchaser may transfer the Software to another computer for use
for all normal purposes, PROVIDED THAT THE PUBLISHER IS USED ON ONLY
ONE COMPUTER AT A TIME.

4.  The purchaser may make additional copies of the software for
transfer to others for purposes of demonstration, testing and review,
but the purchaser shall not make, or cause or permit to be made, any
copy of the printed Rubicon Publisher reference manual or any part
thereof.

5.  The Purchaser shall have the right to acquire a licence to use any
updated version of the Software released during the twelve months next
following the purchase of this licence, upon payment to Rubicon Computer
Labs of an update license fee of US $15.00.

6.  The Software is licensed to the Purchaser without warranty of any
kind, express or implied, except as to title, and all such other
warranties, including those otherwise implied by statute or common law,
are hereby expressly disclaimed.

7.  Except as and to the extent expressly stipulated herein, neither
RUBICON COMPUTER LABS INC. nor any succcessor to or affiliate of RUBICON
COMPUTER LABS INC., nor any officer, employee, agent or representative
of either, shall be liable for any loss, damage, claim, liability or
expense, of any kind or nature whatsoever, arising out of or in
connection with the acquisition, installation or use, or attempted
installation or use, of the Software, including, without restricting the
generality of the foregoing, any loss or damage, direct or
consequential, caused in whole or in part by any real or alleged failure
of or defect in the Software.

8.  Acceptance, installation and/or use of the Software by the Purchaser
constitutes acceptance of the terms and conditions of this licence.
Unless and until the Purchaser has paid the prescribed licence fee, use
of the Software by the Purchaser shall be limited to the purposes of
evaluation, demonstration and review.